Examples: use the converters the API spec documents - #73

Three examples call converters that the production API spec (https://v2.convertapi.com/info/openapi, 332 paths on 2026-11-09) does not list. Developers copy these examples and the how-to guides on convertapi.com reuse them, so they should call documented converters. This is the PHP part of what ConvertAPI/convertapi-library-dotnet#86 does for .NET.

https://www.convertapi.com/web-to-pdf is not in the site's sitemap; https://www.convertapi.com/html-to-pdf is. The other examples already call documented converters; the pdf -> extract step of create_pdf_thumbnail.php goes away with #72.

Verified against production (2026-11-09)

PHP 8.4.27 in Docker (php:8.4-cli): php -l passes for the three files. Each example ran with php <name>.php from examples/, once on main (8874aff) and once on this branch, with the token in CONVERT_API_SECRET and TMPDIR=/out.

conversions_chaining.php, same output before and after:

Converting PDF to JPG and compressing result files with ZIP
Conversions done. Cost: 1. Total files created: 6
Conversions done. Cost: 1. Total files created: 1
File saved to
Array
(
    [0] => /out/test.zip
)

Both runs saved a 775,249-byte test.zip with test.jpg to test-6.jpg; the JPGs are byte-identical before and after.

convert_url_to_pdf.php, same output before and after:

The web page PDF saved to
Array
(
    [0] => /out/web-example.pdf
)

The PDF text: on this branch the PDF is the article (3 pages, 1,925 words, title "Data conversion"). On main, Wikimedia answered ConvertAPI's renderer with its "Too many requests" page (1 page, 62 words); that rate limiting comes and goes for both converters and is being looked at separately.

error_handling.php, before:

Got API error code: 4000
Parameter validation error. Code: 4000 {"SourceFormat, DestinationFormat":["Unsupported conversion docx -> svg"]}

after:

Got API error code: 4000
Parameter validation error. Code: 4000 {"File":["File must be a file with one of the following extensions: .pdf."]}

Seen, not changed: the library itself sends url as the source format when the parameters have a Url and no source format is given (lib/ConvertApi/Task.php, DEFAULT_URL_FORMAT); url is not in the spec. The URL example passes its source format, so it does not depend on it.

Same change in the other SDKs

• Go: Examples: use the converters the API spec documents convertapi-library-go#22
• Java: Examples: use the converters the API spec documents convertapi-library-java#58
• Node: Examples: use the converters the API spec documents convertapi-library-node#125
• Python: Examples: use the converters the API spec documents convertapi-library-python#62
• Ruby: Examples: use the converters the API spec documents convertapi-library-ruby#43
• .NET: Examples: use documented converters, read the production catalog, save SplitPDF to temp, hide account secrets convertapi-library-dotnet#86
• JS (browser): no change needed; its README calls only documented converters.

🤖 Generated with Claude Code